Skip to content

docs: EPIPHANIES.md — ledger efficiency + ambient arc-knowledge loss findings#111

Merged
AdaWorldAPI merged 2 commits into
masterfrom
claude/ledger-efficiency-epiphany
Apr 19, 2026
Merged

docs: EPIPHANIES.md — ledger efficiency + ambient arc-knowledge loss findings#111
AdaWorldAPI merged 2 commits into
masterfrom
claude/ledger-efficiency-epiphany

Conversation

@AdaWorldAPI
Copy link
Copy Markdown
Owner

Summary

Create .claude/board/EPIPHANIES.md with two findings:

  • 10⁷× find-code: prompt↔PR ledger replaces full-codebase grep (~25M tokens) with one ledger grep (~25 tokens)
  • 30-50% ambient arc-knowledge loss: per-turn waste from rediscovering code paths, decisions, reversals — closed by ledger + PR_ARC reads

First deployments: PR #110 (ndarray, 25 prompts mapped, ~90s) + PR #213 (lance-graph, 41 prompts mapped).

Test plan

  • Docs-only (zero code changes)
  • Append-only file created via cat >>

https://claude.ai/code/session_01SbYsmmbPf9YQuYbHZN52Zh

claude added 2 commits April 19, 2026 14:20
Create .claude/board/EPIPHANIES.md with the finding. PR #110 + lance-graph
PR #213 demonstrated the dumb-bookkeeper pattern: ~90 seconds, Haiku,
enumerate+match+append. Result is a grep-addressable index of every
shipped artifact keyed by the prompt-file brief that birthed it.

For every future "what did we ship about X" query the ledger replaces
a full-codebase grep with a single line — ~25 tokens vs ~25M tokens.
Seven orders of magnitude cheaper.

https://claude.ai/code/session_01SbYsmmbPf9YQuYbHZN52Zh
…ambient)

Third finding appended to EPIPHANIES.md — orthogonal to cold-start tax
(20-30 turns) and find-code discount (10⁷×). This is the AMBIENT channel:
30-50% of every session's token budget burns on rediscovering what code
paths exist / what was tried / why code is shaped the way it is.

The prompt↔PR ledger collapses all three channels to two text-file reads:
- Cold-start: 20-30 turns → 3-5 turns   (~6×)
- Find-code:  ~25M tokens → ~25 tokens  (10⁷×)
- Ambient:    30-50% → 0%               (2×-eternal)

https://claude.ai/code/session_01SbYsmmbPf9YQuYbHZN52Zh
@AdaWorldAPI AdaWorldAPI merged commit bccc8e3 into master Apr 19, 2026
5 of 14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants